uxstr FTP PUT - Envoyer des fichiers

Cette section décrit la commande uxstr FTP PUT utilisée pour envoyer des fichiers sur un serveur FTP.

Cette commande permet d'envoyer un ou plusieurs fichiers sur un serveur FTP.

• OS Linux et assimilés : les fichiers sont envoyés avec leurs permissions d'origine.
• Windows : les fichiers sont envoyés avec une permission de 755 (la permission en octal n'existe pas sous Windows).

Note: L'option CRLF n'est pas disponible pour FTP PUT.

Sa syntaxe est la suivante :

uxstr FTP PUT PARTNER=hostname [ORIGIN_FILENAME=filename] [ORIGIN_PATHNAME=path] [TARGET_FILENAME=filename] [TARGET_PATHNAME=path] [LOGON=username] [PASSWORD=password] [MODE=ASCII|BINARY] [ACTION=REPLACE|ABORT|APPEND|NONE] [DELETE|NODELETE] [NEWER|NONEWER] [RECURSIVE|NORECURSIVE] [BUFFER_SIZE=nn] [RETRY=n]

Description des items

• PARTNER=

  Nom physique de la machine cible ou adresse IP.
  Format : 255 caractères alphanumériques

• ORIGIN_FILENAME=

  (Optionnel) Nom du fichier local à envoyer sur le serveur FTP.
  Format : 256 caractères alphanumériques

  Défaut : tous les fichiers du répertoire.

• ORIGIN_PATHNAME=

  (Optionnel) Nom du répertoire local à partir duquel les fichiers sont envoyés.
  Format 256 caractères alphanumériques. Caractère * interdit. Les chemins doivent être écrits comme des chemins de commande FTP, par exemple le chemin "C:\Temp\Transfer" doit être écrit: "C:/Temp/Transfer".

  Défaut : répertoire de connexion de l'utilisateur FTP.

• TARGET_FILENAME=

  (Optionnel) Nom du fichier sur le serveur FTP, uniquement si un seul fichier doit être envoyé.
  Format : 256 caractères alphanumériques

  Défaut : nom inchangé

• TARGET_PATHNAME=

  (Optionnel) Nom du répertoire de destination sur le serveur FTP dans lequel les fichiers doivent être envoyés. .
  Format : 256 caractères alphanumériques. Caractère * interdit.

  Défaut : nom du répertoire de connexion du compte de soumission de l'Uproc.

• LOGON=

  (Optionnel) Utilisateur de connexion FTP.
  Format : 32 caractères alphanumériques.

  Défaut : anonymous

• PASSWORD=

  (Optionnel) Mot de passe de l'utilisateur de connexion FTP. Le mot de passe est invisible dans l'interface graphique.
  Format : 32 caractères alphanumériques

• MODE=

  (Optionnel) Type de transfert : ASCII ou BINARY.

  Défaut : ASCII

• ACTION=

  (Optionnel) Comportement si le fichier cible existe déjà :

  • REPLACE : remplacer le fichier existant.
  • APPEND : concatène le fichier au fichier existant.
  • ABORT : annuler le transfert et sortir en erreur.
  • NONE : ne rien faire.

  Défaut : ABORT

• DELETE | NODELETE

  (Optionnel) Suppression du fichier origine

  • DELETE: supprime le fichier origine si le transfert est réussi.
  • NODELETE : le fichier origine n'est pas supprimé si le transfert est réussi.

  Défaut : NODELETE

• NEWER | NONEWER

  (Optionnel) Vérification de la date du fichier

  • NEWER : transfère le fichier si sa date de modification est plus récente que celle du fichier cible.
  • NONEWER : transfère le fichier quelle que soit sa date.

  Défaut : NONEWER

  Attention ! Cette option n'est pas supportée par défaut par SFTP. Pour savoir si SFTP a été configuré, reportez-vous à la valeur du paramètre nœud U_FT_SFTP. U_FT_SFTP.

• RECURSIVE | NORECURSIVE

  (Optionnel) Fichiers transférés

  • RECURSIVE : transfère tous les fichiers et sous-répertoires contenus dans le chemin ORIGIN_PATHNAME (les paramètres ORIGIN_FILENAME et TARGET_FILENAME ne doivent plus être saisis). Le nombre de niveaux de répertoires ne doit pas dépasser 150.
  • NORECURSIVE : seuls les fichiers du répertoire courant sont transférés.

  Défaut : NORECURSIVE.

  L'option RECURSIVE utilise en interne la commande FTP LIST pour obtenir la liste des fichiers et des répertoires du serveur distant. La réponse attendue du serveur doit être formatée de telle sorte que chaque ligne doit commencer par les droits des fichiers au format UNIX. Cette réponse variant d'un serveur à un autre, la fonction ne pourra pas être utilisée si la réponse a un format différent. Dans ce cas, un fonctionnement dégradé peut être utilisé : chaque fichier du serveur distant est testé à l'aide d'une commande FTP CWD pour vérifier l'existence d'un répertoire. Ce fonctionnement dégradé est moins performant mais il peut être activé à l'aide du paramètre nœud U_FT_GET_DIR_FAILOVER dans la catégorie "Paramètres nœud – Paramétrage FTP".

  • Lors de la récupération d'un répertoire en mode RECURSIVE à l'aide d'une Uproc FTP_GET, le mode Append n'est pas supporté, l'action Abort est utilisée par défaut.

• BUFFER_SIZE=

  (Optionnel) Définit la taille du buffer de communication en blocs de 512 octets.
  Format : nombre entier pair entre 1 et 64.

  Défaut : défaut FTP

• RETRY=

  (Optionnel) Nombre d'essais en cas d'échec de transmission.
  Format : 1 caractère numérique.

Exemple

• Envoie le fichier /tmp/data.txt sur l'hôte cible hp10201, mais interrompt le transfert si le fichier existe déjà:

  uxstr FTP PUT PARTNER=”hp10201” ORIGIN_FILENAME=”data.txt” TARGET_PATHNAME=”/tmp/” ACTION=ABORT